ARS Modify Service Utility

Address Resolution Service > ARS Utilities > ARS Modify Service Utility

ARS Modify Service Utility

The ARS Modify Service utility (ARSModifyService.exe) is a command-line utility used to add, update, or delete a record from an Address Resolution Service (ARS).

The command-line options are described below and can be shown by typing:

C:\CygNet\Utilities\ArsModifyService /?

This utility can be executed while the ARS is running.

Syntax

ARSModifyService {Action} <Site.Service> <Service Type> [Service Desc][DomainID[ARS Name]]

Parameters

Parameter	Definition
{Action}	This required parameter specifies the action. Options are: ADD — add a record to the ARS. UPDATE — update a record in the ARS. DELETE — delete a record from the ARS.
<Site.Service>	This required parameter specifies the name of the service record (in the format Site.Service) on which to perform the action.
<Service Type>	This parameter is required for an ADD action and is optional for an UPDATE action. It specifies the service type. See ARS Service Types for a complete listing. To update only the service type, you must include a blank (double quotes, "") for the Service Desc parameter.
[Service Desc]	This parameter is optional ADD and UPDATE actions. It specifies the service description. If the description is more than one word, include the words in double quotation marks, for example, "Replicated VHS." If not included with the ADD action, the description of the service type will be used. If including the [ARS Name] in the command line, include a blank (double quotes, "") to set the default description.
[Domain ID[ARS Name]]	This parameter is optionally used to specify the ARS (in the format Site.Service) in which to ADD the record. If this parameter is not included, the default ARS of the machine on which the utility is run will be updated. The Domain ID is optional. If used the Domain ID must be listed for the machine on which the utility is run. Use the CygNet Domain Connection Utility to verify the listing.

Examples

ArsModifyService ADD MYSITE.HSS2 "CVS" "Rate Calc HSS" MYSITE.ARS

This example adds a service named "MYSITE.HSS2" to the ARS named "MYSITE.ARS." The service type is "CVS" and the service description is "Rate Calc HSS."

ArsModifyService ADD MYSITE.VHS "VHS" "Replicated VHS" [5454]MYSITE.ARS

This example adds a service named "MYSITE.VHS" to the ARS named "MYSITE.ARS" that is in domain 5454. The service type is "VHS" and the service description is "Replicated VHS."

ArsModifyService ADD MYSITE.SVCMON "CVS"

This example adds a service named "MYSITE.SVCMON" to the ARS named "MYSITE.ARS." The service type is "CVS." Since a Service Description is not specified, it will default to the description of the Service Type, which in this case would be "Current Value Service."

ArsModifyService DELETE MYSITE.VHS2 MYSITE.ARS

This example deletes the service named "MYSITE.VHS2" from the ARS named "MYSITE.ARS."

ArsModifyService UPDATE MYSITE.VHS2 "VHS" "Forwarded VHS"

This example updates the entry for the service named "MYSITE.VHS2" to "Forwarded ARS." Since the ARS is not specified, the update occurs in the ARS in the default domain.

ArsModifyService UPDATE MYSITE.SVCMON "" "Service Monitoring"

This example updates the description for the service named "MYSITE.SVCMON" to "Service Monitoring."